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RESEARCH  SUMMARY 

The  Event  Monitor  dynamically  invokes  management 
activities  to  be  simulated  by  the  Prognosis  Model.  Activities 
include  simulated  thinnings,  harvesting,  plantings,  or  any 
other  activity  that  the  simulation  model  can  mimic.  The  Event 
Monitor  accepts  statements  of  conditions  to  be  met  and  a  set 
of  activities  to  be  simulated  when  the  conditions  are  met. 
The  conditions  are  logical  expressions  of  stand-state  vari- 
ables. The  combination  of  a  condition  and  a  set  of  activities 
is  considered  a  rule  of  stand  management.  One  or  more 
rules  may  be  used  to  define  a  stand  management  policy. 

Stand  management  policies  may  be  evaluated  without 
users  foretelling  the  development  of  stands  in  an  analysis 
and  manually  scheduling  activities.  If  the  policy  statements 
are  defined  by  experts  so  that  they  apply  to  the  management 


of  many  stands,  the  system  will  output  suggested  manage- 
ment schedules  that  reflect  the  policies  of  experts  for  each 
stand.  The  rules  that  define  these  policies  can  be  shared 
between  users. 

This  user's  guide  replaces  General  Technical  Report 
INT-196  (Crookston  1985).  Most  old  features  of  the  Event 
Monitor  have  been  retained;  several  new  features  have  been 
added  as  described  herein.  Several  additional  arithmetic 
functions  and  stand-state  variables  are  now  available.  New 
stand-state  variables  can  be  defined  as  a  function  of  other 
stand-state  variables,  and  the  new  variables  can  be  used 
in  expressions.  Functions  of  stand-state  variables  can  be 
coded  in  place  of  constants  on  some  Prognosis  Model  key- 
words. Stand  management  rules  can  be  labeled  and  related 
to  each  other  using  labels. 
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Nicholas  L.  Crookston 


INTRODUCTION 

Stand  management  activities  are  often  contingent  upon  several  factors.  Thinning 
may  be  called  for  if  the  stand  is  too  dense,  or  spraying  may  be  required  if  an  insect 
population  is  causing  too  much  damage.  Usually,  users  of  stand-growth  simulation 
models  must  foretell  the  occurrence  of  stand  conditions  that  require  management 
actions  and  preschedule  the  program  options  that  represent  those  actions. 

The  Event  Monitor  offers  an  alternative  method  of  scheduling  activities:  You 
specify  a  set  of  conditions  that  must  occur,  or  thresholds  that  must  be  reached.  The 
conditions  are  called  an  event.  You  also  specify  a  set  of  management  activities  for 
the  model  to  simulate  when  and  if  the  event  occurs.  For  example,  suppose  you  wish 
to  schedule  a  thinning  only  if  the  stand  crown  competition  factor  (Krajicek  and  oth- 
ers 1961)  exceeds  150,  trees  per  acre  exceed  500,  and  age  is  greater  than  20  and  less 
than  60  years.  Using  the  Event  Monitor,  the  condition  is  specified  via  a  logical  ex- 
pression followed  by  the  activities  (represented  by  Prognosis  Model  options)  that  are 
to  be  invoked  when  that  expression  is  true. 

Taken  together,  an  event  and  the  management  activities  may  be  viewed  as  a 
management  rule.  One  or  more  rules  may  be  considered  a  management  policy  state- 
ment. Thus,  policy  statements  may  be  evaluated  using  the  Prognosis  Model  without 
users  foretelling  the  development  of  each  stand  in  an  analysis  in  order  to  manually 
schedule  activities. 

If  the  policy  statements  are  defined  by  management  experts  in  such  a  way  that 
they  apply  to  the  management  of  a  large  number  of  stands,  the  Event  Monitor  can 
be  used  to  provide  suggested  management  schedules  that  reflect  the  management 
policies  of  those  experts.  The  rules  that  defi.ne  these  policies  can  be  shared  between 
you  and  your  colleagues.  In  this  way,  the  Prognosis  Model  can  be  used  to  share 
management  expertise. 

The  Event  Monitor  was  added  to  the  Prognosis  Model  when  Version  5  was  created 
(Crookston  1985).  This  guide  applies  to  Version  6  of  the  model  and  completely  re- 
places the  original  version. 

Most  features  of  the  old  version  have  been  retained,  and  several  arithmetic  func- 
tions and  stand-state  variables  that  can  be  used  in  expressions  have  been  added. 
Further,  new  stand-state  variables  can  be  defined  as  functions  of  other  stand-state 
variables,  and  the  new  variables  can  be  used  in  expressions.  Functions  of  stand- 
state  variables  can  be  coded  in  place  of  constants  on  some  Prognosis  Model  key- 
words. Stand  management  rules  can  be  labeled  and  related  to  each  other  using 
labels.  The  only  deleted  feature  concerns  some  species-specific  density  measures 
as  described  in  appendix  B. 

In  this  guide,  straightforward  applications  are  presented  first  and  advanced 
features  follow.  You  should  already  be  familiar  with  the  Prognosis  Model.  Terms, 
operational  rules,  and  concepts  explained  in  the  Prognosis  Model  user's  guides 
(Ferguson  and  Crookston  1984;  Wykoflf  1986;  Wykoff  and  others  1982)  are  used 
here  without  explanation. 
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EVENT  MONITOR  USE 


An  event  is  designated  by  an  IF  keyword  record,  followed  by  a  logical  expres- 
sion. The  expression  is  coded  on  one  or  more  supplemental  data  records.  It  may 
contain  constants,  arithmetic  operators,  parentheses,  relational  and  logical  opera- 
tors (greater  than  (GT),  less  than  (LT),  equal  (EQ),  AND,  OR,  etc.),  and  certain 
variables.  Following  the  logical  expression,  a  THEN  keyword  record  is  entered; 
it  signals  the  end  of  the  logical  expression  and  the  beginning  of  the  activities  that 
will  be  scheduled  only  when  the  expression  is  true.  Any  Prognosis  Model  keyword 
option  (including  those  found  in  extensions)  that  can  be  scheduled  by  entering  a 
cycle  number  or  year  in  the  first  numeric  field  can  be  scheduled  by  the  Event 
Monitor.  An  ENDIF  keyword  is  entered  to  signal  that  normal  activity  processing 
should  resume. 

The  value  in  field  1  of  activity  keyword  records  is  added  to  the  year  the  event 
occurs.  The  sum  becomes  the  year  the  activity  is  scheduled.  Therefore,  the  value 
in  field  1  is  called  the  waiting  time  when  the  activity  keyword  is  used  in  the  con  - 
text of  an  Event  Monitor  rule. 

Assume  the  following  policy:  If  before-thinning  crown  competition  factor 
THEN  and  ENDIF     (BCCF)  is  greater  than  150,  and  before-thinning  trees  per  acre  (BTPA)  is  greater 
'  than  500,  and  age  is  greater  than  20  and  less  than  60,  then  thin  from  below  to 

a  residual  stand  density  of  300  trees  per  acre.  This  policy  can  be  simulated  with 
the  keywords  outlined  below: 


Example  1:     Illustrate  IF,   THEN,   and  ENDIF 

Keyword  record 

Reference 

1  ine 

Keyword 

Field  1     Field  2     Field  3     Field  4     Field  5 

Field  6     Field  7 

1 

STDIDENT 

2 

EXAMPLEl 

Illustrate  IF,   THEN,  and 

ENDIF 

3 

INVYEAR 

1990. 

4 

NUMCYCLE 

7 . 

5 

IF 

6 

BCCF  GT 

150  AND  BTPA  GT   500  AND  AGE  & 

7 

GT  20  AND  AGE  LT  60 

8 

THEN 

9 

THINBTA 

0.  300. 

10 

ENDIF 

11 

STDINFO 

118.            590.            30.           135.  50. 

56. 

12 

PROCESS 

13 

STOP 

The  tree  data  and  some  of  the  output  created  by  running  this  example  are  in 
appendix  A;  further  explanation  of  the  input  file  follows: 

Lines  1  and  2:  Enter  the  stand  identification  and  a  run  title. 

Line  3:  Specify  the  inventory  year. 

Line  4:  Specify  the  number  of  cycles. 

Line  5:  IF  signals  that  a  logical  expression  follows. 

Lines  6  and  7:  The  logical  expression  is  coded  "free  form"  (that  is,  characters 
need  not  be  placed  in  specific  columns)  on  one  or  more  supplemental  data  records 
that  follow  the  IF  keyword.  An  ampersand  at  the  end  of  a  line  signals  that  the 
expression  is  continued  on  the  following  record. 

Line  8:  THEN  signals  that  the  activities  (options  specified  by  date  or  cycle)  that 
follow  will  not  be  scheduled  until  after  the  event  happens;  that  is,  when  the  logi- 
cal expression  is  true. 


IF,  THEN,  and 
ENDIF 


Waiting  Time  for 

Activity 

Scheduling 

Illustrate  IF, 
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Line  9:  THINBTA  is  a  thinning  option  that  will  be  scheduled  in  the  same  year 
that  the  event  happens;  thus,  a  zero  is  coded  in  field  1.  The  residual  trees  per  acre 
are  coded  in  field  2. 

Line  10:  ENDIF  marks  the  end  of  the  conditionally  specified  options. 

Line  11:  Enter  data  specific  to  the  stand  such  as  the  forest  code. 

Line  12:  All  keywords  have  been  entered;  begin  processing. 

Line  13:  Stop  the  Prognosis  Model. 


Basic  Keywords 


When 

Expressions  Are 
Evaluated 


DETAILED  INSTRUCTIONS 

As  illustrated  above,  the  IF  keyword  is  used  to  signal  that  a  logical  expression 
follows.  The  THEN  keyword  signals  that  the  activities  that  follow  should  be  sched- 
uled only  when  the  logical  expression  is  true.  Note  that  several  activities  may  fol- 
low a  THEN  keyword.  Scheduling  activities  that  follow  the  ENDIF  keyword  does 
not  depend  on  the  logical  expression. 

IF  Signals  that  the  logical  expression  follows  on  one  or  more  supplemental 

data  records. 

field  1:    The  minimum  waiting  time  before  the  event  may  happen  again; 
default  is  zero  years. 

Supplemental  data  record(s): 

Contains  a  logical  expression  like  the  one  illustrated  in  example  1. 
Use  an  ampersand  (&)  to  indicate  that  an  expression  is  continued  on 
the  next  record.  You  may  use  a  maximum  of  200  characters  in  an  ex- 
pression. See  the  section  "Coding  Expressions"  for  more  instructions. 

THEN     Signals  that  the  activities  that  follow  will  be  scheduled  when  the  event 
happens.  Field  1  of  this  keyword  is  described  later. 

ENDIF    Activities  that  follow  an  ENDIF  are  scheduled  normally. 

The  Event  Monitor  evaluates  expressions  at  each  of  two  different  times  during 
a  growth  cycle  (fig.  1):  once  at  the  beginning  of  the  growth  cycle  prior  to  thinnings, 
and  once  after  thinnings.  A  logical  expression  that  tests  on  before-thin  density  can 
be  used  to  trigger  a  thinning  during  the  same  cycle.  If  the  logical  expression  uses 
a  variable  that  depends  on  an  after-thin  density,  a  thinning  cannot  be  scheduled 
for  the  same  cycle  but  it  can  be  scheduled  for  a  later  cycle  by  coding  a  waiting  time 
longer  than  the  current  cycle  length  in  field  1  on  the  thinning  keyword. 


— ^  For  all  stands 

Input  and  initialization 
I — ^  For  all  time  steps 

Call  Event  Monitor 

Simulate  Cutting 
Call  Event  Monitor 
Predict  Growth 
Update  state  variables 
Add  Regeneration 

' — <  Next  time  step 

Write  Reports  Figure  1— The  Event  Monitor  is 
called  at  the  beginning  of  each 
<  Next  stand  (jme  step  and  after  simulated 
  cutting. 
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The  Regeneration  Establishment  Model  is  called  near  the  end  of  a  cycle. 
Therefore,  it  is  possible  to  trigger  a  call  to  the  establishment  model  as  a  response 
to  a  before-thin  or  an  after-thin  density. 

You  can  schedule  a  thinning  in  response  to  detecting  that  a  thinning  has 
occurred.  But  the  conditionally  scheduled  thinning  cannot  be  simulated  during 
the  same  cycle  the  event  is  detected  because  the  event  is,  itself,  another  thinning. 
You  can  specify  that  the  conditionally  scheduled  thinning  be  scheduled  10  years 
after  the  event  occurs  by  coding  a  waiting  time  in  field  1  of  the  desired  thinning 
keyword  record.  If  the  cycle  length  is  less  than  or  equal  to  the  waiting  time,  the 
conditionally  scheduled  thinning  will  be  simulated  in  the  following  cycle. 

The  list  of  variables  that  can  be  used  in  expressions  is  in  appendix  B.  The  list 
is  divided  into  four  groups  based  on  when  the  variables  are  defined.  If  any  vari- 
able is  undefined  when  a  logical  expression  is  evaluated,  the  expression  is  false. 

Variables  listed  in  group  1  are  always  known;  you  can  include  them  in  expres- 
sions either  by  themselves  or  with  those  listed  in  the  other  groups. 

Group  2  variables  are  undefined  when  the  Event  Monitor  evaluates  expressions 
prior  to  thinnings.  However,  they  are  correctly  defined  when  expressions  are 
evaluated  following  thinnings,  even  if  no  thinnings  occur. 

Group  3  variables  are  not  defined  until  after  the  first  Prognosis  Model  cycle. 
For  example,  the  stand  accretion  is  computed  after  the  second  time  the  Event 
Monitor  evaluates  logical  expressions  each  cycle.  Therefore,  the  stand  accretion 
variable  is  assigned  the  accretion  from  the  previous  cycle.  Variables  that  measure 
change,  such  as  DBA  (delta  basal  area,  the  change  in  basal  area  from  cycle  to 
cycle),  are  computed  by  subtracting  the  value  stored  from  the  previous  cycle  from 
the  current  value.  These  variables  are  also  undefined  until  the  beginning  of  the 
second  Prognosis  Model  cycle.  After  the  second  cycle  starts,  group  3  variables  are 
defined. 

Group  4  variables  are  assigned  values  by  Prognosis  Model  extensions.  The 
value  of  these  variables  remains  undefined  unless  the  appropriate  extension 
defines  them. 


When  Event 
Monitor  Variables 
Are  Defined 


Coding  Expressions  consist  of  variables  (appendix  B),  constants,  parentheses,  arithme- 

Expressions  operators,  and  logical  operators  in  logical  expressions.  All  of  the  permissible 

operators  are  listed  in  appendix  C.  When  coding  expressions,  follow  these  rules: 

•  A  parenthesis  or  blank  must  precede  and  follow  logical  operators:  AGE  GT 
25  is  valid,  AGE  GT(25)  is  valid,  AGE  GT25  is  invalid. 

•  A  parenthesis,  constant,  or  variable  must  separate  two  arithmetic  operators: 
AGE*-2.5  is  invalid,  AGE*(-2.5)  and  -2.5*AGE  are  valid. 

•  Operators  are  executed  in  order  of  precedence  given  in  appendix  C,  or 
parentheses  may  be  used  to  control  the  precedence  of  evaluation. 

•  When  equally  ranked  operations  are  found,  evaluation  proceeds  from  left 
to  right. 

•  Constants  are  treated  as  floating  point  numbers  whether  or  not  a  decimal 
point  is  coded.  For  example,  300  is  converted  to  300.0. 

•  Arguments  to  functions  found  in  appendix  C  are  considered  expressions. 

An  argument  to  a  function  may  reference  any  function  including  the  original 
function.  That  is,  DECADE(TIME(A,B,C),D/E,AL0G(4*AL0G{F)))  is  valid 
if  variables  A  through  F  are  appropriately  defined. 

•  An  ampersand  (&)  signals  that  expressions  are  continued  on  the  next  line. 
Any  characters  that  follow  the  ampersand  are  output  as  comments. 
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•  Expressions  may  contain  up  to  200  characters.  Strings  of  blanks  count  as  one 
character;  ampersands  and  characters  that  follow  ampersands  do  not  count. 

•  The  following  are  valid  (and  equivalent)  logical  expressions: 

(BTPA*2  GE  1000  OR  AGE  GT  50.) 

(NOT  BTPA  LT  500)  OR  (NOT  AGE  LE  50.0) 

NOT  (BTPA  LT  500  AND  AGE  LE  50) 

•  The  following  are  invalid: 

(ATPA  .LT.  500.) — the  inclusion  of  the  periods  before  and  after  the 
less-than  operator  is  valid  in  FORTRAN  but  not  in  the  Event  Monitor. 
(NOT  (BTPA  LT  50)— Unbalanced  parentheses. 


ADVANCED  FEATURES 

Since  its  introduction,  the  Event  Monitor  has  been  enhanced  as  follows: 

1.  A  COMPUTE  option  allows  you  to  define  variables  that  can  be  used  in  logical 
expressions,  in  other  COMPUTE  options,  and  as  parameters  on  keyword  records. 

2.  You  can  code  expressions  in  place  of  constant  parameters  on  some  activity  key- 
words. For  example,  the  residual  stand  density  on  thinning  keywords  can  be  a  func- 
tion of  current  stand  statistics. 

3.  You  can  relate  rules  to  each  other  by  labeling  them  with  the  same  name.  These 
related  rules  can  be  treated  like  a  fiilly  described  management  policy.  Stands  are 
labeled  with  the  name(s)  of  the  management  policies  that  apply  to  them. 

4.  You  can  create  decision  trees  when  using  the  Event  Monitor  in  conjunction 
with  the  Parallel  Processing  Extension  (PPE)  of  the  Prognosis  Model  (Crookston 
and  Stage  1989). 


The  COMPUTE 
Keyword 


The  COMPUTE  keyword  allows  you  to  define  up  to  10  variables  expressed  as  func- 
tions of  Event  Monitor  variables  (appendix  B),  constants,  and  variables  previously 
defined  using  the  COMPUTE  feature.  The  COMPUTE  option  can  be  scheduled  for 
specific  years,  and  the  value  of  variables  may  depend  on  an  event. 

COMPUTE     Enter  one  or  more  expressions  that  define  variables. 

field  1:   The  date  or  cycle  in  which  the  expression  is  to  be  evaluated; 
default  is  1.  Enter  a  0.0  if  you  want  the  expression  to  be 
evaluated  every  cycle. 

Supplemental  data  record(s): 

Contains  expressions  such  as:  NORMAL  =  25000*(BADBH+1)** 
(-1.588).  Names  that  appear  on  the  left-hand  side  of  the  equal  sign 
may  not  be  longer  than  eight  characters  and  may  not  be  names  found 
in  appendix  C.  Variable  names  found  on  the  right-hand  side  of  an 
equal  sign  must  be  previously  defined  using  the  COMPUTE  option 
or  be  variables  found  in  appendixes  B  or  C.  Use  an  ampersand  (&) 
to  indicate  that  an  expression  is  continued  on  the  next  record.  Code 
subsequent  expressions  on  subsequent  supplemental  data  records 
and  enter  an  END  keyword  after  the  last  expression  is  entered. 
Use  up  to  200  characters  for  each  expression. 

The  following  keyword  segment  illustrates  how  to  use  the  COMPUTE  option. 
Note  that  this  keyword  segment  does  not  define  a  complete  run. 
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Example 

2:     Using  the  COMPUTE  feature  to  define  two  variables 

Keyword  record 

Reference 

1  ine 

Keyword 

Field  1     Field  2     Field  3     Field  4     Field  5     Field  6     Field  7 

1 

COMPUTE 

0.0 

2 

NORMAL  = 

25000* (BADBH+1) ** (-1.588) 

3 

PROPCUT  = 

NORMAL/BTPA 

4 

END 

Line  1:  The  COMPUTE  keyword  has  a  0.0  in  field  1  indicating  that  the  variables 
(NORMAL  in  line  2,  and  PROPCUT  in  line  3)  should  be  calculated  every  cycle. 

Line  2:  Compute  the  NORMAL  stocking  in  trees  per  acre  using  an  equation 
based  on  Haig's  (1932)  yield  tables  for  western  white  pine  type  (see  Wykoff  and 
others  1982,  page  71).  The  variable  BADBH  is  the  average  before-thinning  diam- 
eter at  breast  height  (see  group  1  in  appendix  B). 

Line  3:  Compute  PROPCUT,  the  proportion  of  the  current  trees  per  acre  that 
need  to  be  cut  to  reach  NORMAL  stocking. 

Line  4:  Signal  the  end  of  COMPUTE  processing. 


Coding 
Expressions 
on  Activity 
Keywords 


You  may  code  expressions  in  place  of  constant  parameters  on  many  activity  key- 
word records.  This  is  possible  for  all  of  the  thinning  keywords,  all  of  the  growth 
rate  multiplier  keywords,  the  top-killing  keywords,  the  FIXMORT  keyword,  and 
the  defect  keywords  MCDEFECT  and  BFDEFECT.  If  a  keyword  is  not  an  activity 
keyword,  this  feature  may  not  be  used  (there  are  two  exceptions,  THEN  and 
ALSOTRY,  discussed  in  the  PPE  user's  guide,  Crookston  and  Stage  1989). 

To  code  an  expression  on  an  activity  keyword  record,  do  the  following: 

1.  Code  the  keyword  in  the  first  eight  columns  and  the  date/cycle  in  field  1 
of  the  keyword  record  as  done  when  this  feature  is  not  used. 

2.  For  the  other  parameters,  code 

FARMS  (argj,arg2,...,arg^) 

starting  between  columns  21  and  30  of  the  keyword  record.  Each  "arg^"  is  an  ex- 
pression using  constants,  variables  found  in  appendix  B,  and  any  of  the  functions 
and  operators  from  appendix  C  except  the  logical  operators.  Use  an  ampersand 
(&)  to  continue  on  to  the  following  record. 

3.  Ensure  that  parameter  values  are  within  legal  limits.  For  example,  say 
that  argg  is  the  cutting  efficiency  used  on  a  thinning  keyword.  You  must  take 
care  to  insure  that  the  value  of  the  expression  coded  as  argg  is  bounded  by  0.0 
and  1.0,  legal  range  for  the  cutting  efficiency  parameter.  When  PARMS  is  not 
used,  the  Prognosis  Model  ensures  that  the  values  are  within  legal  limits. 

4.  Supply  all  of  the  parameters  used  by  the  activity  keyword.  When  the 
PARMS  feature  is  not  used,  default  values  are  supplied  when  a  keyword  field 
is  left  blank. 

5.  Use  variables  that  are  defined  when  the  activity  is  accomplished  by  the 
Prognosis  Model.  If  the  PARMS  function  references  a  variable  that  is  not  defined 
when  the  activity  is  called  for  by  the  model,  the  activity  is  CANCELED.  For 
example,  if  a  group  2  variable  is  used  to  define  the  residual  density  for  a  thinning 
activity,  the  function  will  be  undefined  when  the  thinning  is  scheduled  and  the 
thinning  will  be  canceled. 

6.  Use  variables  defined  via  COMPUTE  if  you  wish. 

7.  Use  the  PARMS  feature  on  activities  that  are  conditionally  scheduled  or 
scheduled  for  a  specific  date  or  cycle. 
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Study  the  following  examples  of  using  the  FARMS  feature. 


Example  3;     Using  the  PARMS  feature  on  thinning  keywords 

Keyword  record 

Ref srence 

line 

Keyword      Field  1     Field  2     Field  3     Field  4     Field  5     Field  6     Field  7 

1 

THINDBH         1990.          PARMS    ( 10 . ,  99 9 . ,  1 . 0 ,  0 . ,  0 . , 0 . ,  0 . ) 

2 

THINDBH         1990.  10. 

3 

THINBTA         1990.          PARMS    ( BTPA-SPMCDBH (1 , 0 , 3 ) , 1 . , 0 . , 999 . , 0 . , 999 . ) 

4 

IF 

5 

PROPCUT  LT  1.0 

6 

THEN 

7 

THINDBH             0.            PARMS    (0 ., 999 PROPCUT, 0 ., 0 ., 0 ., 0 . ) 

8 

ENDIF 

Lines  1  to  2:  These  two  THINDBH  keywords  are  equivalent;  both  request  that 
all  trees  between  10  and  999  inches  d.b.h.  be  cut  (fields  2  and  3),  that  the  cutting 
efficiency  be  1.0  (field  4),  that  all  species  be  cut  (field  5),  and  that  the  residual  trees 
per  acre  and  basal  area  per  acre  within  the  cut  diameter  class  be  zero  (fields  6 
and  7).  Note  that  only  the  lower  diameter  is  specified  in  the  second  keyword; 
defaults  are  supplied  by  the  Prognosis  Model  for  other  fields. 

Line  3:  The  residual  stand  density  for  a  thin  from  below  to  a  trees-per-acre  value 
(THINBTA)  is  computed  using  the  Event  Monitor  variable  BTPA,  before-thinning 
trees  per  acre,  and  the  SPMCDBH  function  (described  in  appendix  C).  The  resid- 
ual trees  per  acre  is  the  difference  between  the  total  number  of  trees  and  the  num- 
ber of  trees  that  carry  tree-value  class  code  3  (IMC=3). 

The  sequence  that  follows  (lines  4  to  8)  result  in  cutting  every  cycle  such 
that  a  normal  stocking  curve  is  followed. 

Lines  4  to  5:  If  the  proportion  of  trees — PROPCUT  as  defined  using  the 
COMPUTE  keywords  described  in  example  2 — is  less  than  1.0,  then  schedule 
a  thinning  option. 

Line  7:  Use  the  THINDBH  option  to  actually  do  the  thinning.  The  PROPCUT 
is  entered  as  the  cutting  efficiency.  Other  arguments  specify  all  of  the  trees  in  the 
diameter  range  and  all  species. 

Line  8:  End  the  activity  group. 

These  keyword  segments  do  not  define  complete  runs. 


Policy  Labeling: 
AGPLABEL  and 
SPLABEL 


A  condition  described  with  a  logical  expression  combined  with  a  set  of  activities 
is  considered  a  rule  of  stand  management.  One  or  more  rules  may  be  used  to  de- 
fine a  stand  management  policy.  You  can  label  rules  in  the  Event  Monitor.  Two 
or  more  rules  can  be  related  to  one  stand  management  policy  by  labeling  them  with 
the  same  label.  For  example,  say  you  have  a  rule  for  precommercial  thinning,  an- 
other for  commercial  thinning,  and  another  for  final  harvest.  You  may  give  this 
management  policy  a  name  such  as  intensive  and  relate  the  three  rules  to  each 
other  by  labeling  each  of  them  intensive. 

Additionally,  suppose  that  the  commercial  thinning  and  final  harvest  rules  are 
appropriate  for  another  stand  management  policy  called  extensive.  By  labeling 
these  two  rules  with  both  intensive  and  extensive  labels,  two  different  stand  man- 
agement policies  are  defined. 

A  stand  can  be  labeled  with  the  name  of  the  appropriate  stand  management  pol- 
icy. For  example,  if  a  stand  is  labeled  intensive,  then  the  only  stand  management 
rules  that  apply  to  the  stand  are  those  labeled  intensive.  By  alternately  labeling 
a  stand  intensive  for  one  run  of  the  Prognosis  Model  and  extensive  for  another  run, 
the  yields  for  both  management  policies  may  be  conveniently  simulated.  Further- 
more, a  stand  may  be  labeled  with  a  list  of  several  stand  management  policies. 
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Let's  say  you  have  described  two  regeneration  systems  and  labeled  one  clear- 
cutting  and  the  other  shelterwood.  For  a  run  of  the  Prognosis  Model,  you  could 
predict  the  yield  derived  from  running  a  combined  stand  management  policy 
by  labeling  the  stand  with  two  labels,  intensive  and  shelterwood,  for  example. 

Rules  are  labeled  using  an  Activity  Group  Policy  La6eZ  keyword  called 
AGPLABEL.  The  label  is  called  an  activity  group  label  set  because  more  than 
one  name  may  be  associated  with  the  activity  group.  A  Stand  Policy  Label  set 
is  a  list  of  policies  that  apply  to  the  stand  and  it  is  entered  using  the  SPLABEL 
keyword.  An  activity  group  will  not  be  scheduled  if  its  label  set  and  the 
stand's  label  set  do  not  contain  a  common  member. 

If  more  than  one  SPLABEL  set  is  specified  for  a  stand,  or  if  more  than  one 
AGPLABEL  set  is  specified  for  a  single  activity  group,  the  sets  specified  last 
will  be  used  and  the  others  will  be  ignored.  If  no  SPLABEL  set  is  specified,  the 
default  stand  policy  label  set  is  the  union  over  all  of  the  activity  group  policy  label 
sets.  The  SPLABEL  set  is  assigned  to  activity  groups  where  no  AGPLABEL  is 
defined.  If  no  SPLABEL  and  no  AGPLABEL  keywords  are  used  in  the  run,  then 
none  of  the  logic  associated  with  the  labeling  scheme  is  used  by  the  model. 

The  keyword  formats  are: 

AGPLABEL    Enter  the  policy  labels  applicable  to  a  specific  activity  group  on 

supplemental  data  records  that  follow  this  keyword.  The  keyword 
must  follow  the  THEN  keyword  to  which  it  applies  and  be  entered 
before  the  ENDIF  keyword  (another  case  is  described  below  under 
the  ALSOTRY  keyword). 

Supplemental  data  record(s) 

Each  label  must  be  separated  by  one  comma  and  the  total  number 
of  characters  for  all  policies  may  not  exceed  100  including  commas. 
Use  an  ampersand  (&)  to  indicate  that  the  list  is  continued  on  the 
next  record.  Sequences  of  more  than  one  blank  are  converted  to 
one  blank  and  lower-case  letters  are  converted  to  upper-case  let- 
ters. Any  character  may  be  used  as  part  of  the  label  except  com- 
mas, periods,  and  ampersands. 

SPLABEL      Enter  the  policy  labels  applicable  to  a  specific  stand  on  supplemen- 
tal data  records  that  follow  this  keyword.  See  AGPLABEL  for  a 
description  of  how  to  code  the  supplemental  data  record. 

Policy  labeling  is  most  useful  when  using  the  PPE  (Crookston  and  Stage  1989). 
Documentation  of  the  PPE  contains  a  complete  description  and  examples  of  how 
the  Event  Monitor  processes  the  label  sets. 


The  ALSOTRY  In  the  PPE,  ALSOTRY  signals  that  an  alternative  activity  group  should  be 

Keyword  scheduled  for  the  stand.  When  the  logical  expression  is  true,  the  PPE  makes 

a  duplicate  copy  of  the  stand's  state-variables  called  a  replicate.  The  growth  of 
a  stand  replicate  is  simulated  as  if  it  were  another  unique  stand  in  the  PPE.  For 
the  original  stand,  the  activity  group  that  follows  the  THEN  keyword  is  scheduled, 
and  for  the  replicate,  the  activity  group  that  follows  the  ALSOTRY  keyword  is 
scheduled.  If  additional  ALSOTRY  keywords  are  specified,  additional  replicates 
are  created. 

ALSOTRY  can  be  used  to  define  alternative  policies  even  when  not  using  the 
PPE.  For  example,  say  that  both  intensive  and  extensive  management  policies  call 
for  a  commercial  thinning  when  density  is  too  high.  But  the  intensive  stand  man- 
agement policy  also  calls  for  fertilization  (Stage  and  others  1990).  In  this  simple 
example,  one  logical  expression  is  used  to  define  high  density.  The  first  activity 
group  follows  the  THEN  keyword,  contains  the  thinning  and  fertilization  activi- 
ties, and  is  labeled  intensive.  The  second  activity  group  follows  the  ALSOTRY 
keyword,  contains  only  the  thinning  activity,  and  is  labeled  extensive.  The  ENDIF 
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keyword  follows  the  second  activity  group.  If  the  SPLABEL  is  extensive  and  the 
event  occurs,  the  activities  associated  with  the  extensive  policy  will  be  simulated 
and  the  intensive  activities  will  be  ignored. 

Note  that  ALSOTRY  keywords  can  be  used  without  using  the  PPE,  and  there  will 
be  no  errors  as  long  as  stand  duplication  is  not  required  to  simulate  the  run.  Stand 
duplication  is  not  necessary  if  activity  group  label  sets  are  nonoverlapping  and  the 
stand  label  set  contains  only  one  label  that  is  also  in  an  activity  group  label. 

ALSOTRY      Signals  that  an  alternative  group  of  activities  should  be  scheduled 
when  the  event  occurs.  Field  1  is  used  by  the  PPE. 

Example  4  illustrates  an  application  using  APGLABEL,  SPLABEL,  and 
ALSOTRY  keywords  by  expanding  on  example  1. 


Example  4 

:     Illustrate  AGPLABEL,  SPLABEL, 
Keyword  record 

and  ALSOTRY 

Refsirsncs 

1  Ine 

Keyword      Field  1     Field  2     Field  3     Field  4 

Field  5     Field  6     Field  7 

1 

STANDID 

2 

EXAMPLE4     Illustrate  AGPLABEL,    SPLABEL,  and 

ALSOTRY 

3 

INVYEAR 

1990. 

A 

NUMCYCLE 

10. 

5 

IF 

6 

BCCF  GT  150 

AND  BTPA  GT   500  AND  AGE  & 

7 

GT  20  AND  AGE  LT  60 

8 

THEN 

9 

THINBTA 

0.  300. 

10 

FERTILIZ 

1. 

11 

AGPLABEL 

12 

intensive 

13 

ALSOTRY 

14 

THINBTA 

0.  300. 

15 

AGPLABEL 

16 

extensive 

17 

ENDIF 

18 

STDINFO 

118.           710.             30.  135. 

50.  56. 

19 

SPLABEL 

20 

intensive 

21 

PROCESS 

22 

STOP 

Lines  1  and  2:  Enter  the  stand  identification  and  a  run  title. 

Lines  3  and  4:  Specify  the  inventory  year  and  number  of  cycles. 

Line  5  through  7:  Specify  the  event  using  the  same  logic  used  in  example  1. 

Line  8:  THEN  signals  that  the  first  activity  group  follows. 

Lines  9  and  10:  The  THINBTA  and  FERTILIZ  (Stage  and  others  1990)  are  two 
activities  that  form  the  first  activity  group. 

Lines  11  and  12:  AGPLABEL  signals  that  the  activity  group  policy  label  set 
follows  on  the  next  record.  The  label  set  is  intensive. 

Line  13:  ALSOTRY  signals  that  the  second  activity  group  follows. 

Line  14:  The  THINBTA  activity  is  the  only  activity  in  the  second  group. 

Lines  15  and  16:  AGPLABEL  signals  that  the  activity  group  policy  label  set, 
extensive  in  this  case,  follows  on  the  next  record. 

Line  17:  ENDIF  marks  the  end  of  the  conditionally  specified  options. 

Line  18:  Enter  data  specific  to  the  stand  such  as  the  forest  code. 

Lines  19  and  20:  SPLABEL  signals  that  the  stand  policy  label  set  follows.  In  this 
example,  intensive  is  entered.  For  a  different  run  of  the  Prognosis  Model  extensive 
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might  be  desired.  If  the  PPE  was  being  used  both  intensive  and  extensive  could 
be  entered  and  the  PPE  would  simulate  both  policies  as  alternatives. 

Line  21:  Signals  that  all  of  the  keywords  have  been  entered  and  that  the  stand 
should  be  processed. 

Line  22:  Stop  the  Prognosis  Model. 
SUMMARY 

Since  publication  in  1985,  the  Event  Monitor  has  become  popular  with  Progno- 
sis Model  users.  The  success  of  the  initial  system  and  the  need  for  new  features 
led  to  the  development  of  this  version.  The  enhanced  system  is  upwardly  com- 
patible with  the  original  system,  except  for  the  exclusion  of  a  few  variables  as 
described  in  appendix  C.  Some  of  the  new  components  are  most  useful  when 
the  PPE  is  being  used. 

New  features  include  additional  arithmetic  functions  and  stand-state  variables 
that  can  be  used  in  expressions.  A  new  COMPUTE  keyword  allows  you  to  define 
additional  stand-state  variables  as  a  function  of  other  stand-state  variables.  The 
additional  variables  can  be  used  in  other  expressions.  The  new  PARMS  feature 
allows  parameters  to  be  defined  as  expressions  on  activity  keyword  records. 

A  stand  management  rule  is  defined  to  be  a  logical  expression  and  the  accom- 
panying activity  group.  Other  new  keywords,  AGPLABEL  and  SPLABEL,  allow 
stand  management  rules  and  stands  to  be  labeled  and  related  to  each  other.  One 
or  more  rules  are  called  a  stand  management  policy. 

Using  this  system,  stand  management  policies  may  be  evaluated  without  users 
foretelling  the  development  of  stands  in  an  analysis  and  manually  scheduling 
activities.  If  the  policy  statements  are  defined  by  experts  so  that  they  apply  to 
the  management  of  many  stands,  the  system  will  output  suggested  management 
schedules  that  reflect  the  policies  of  these  experts  for  each  stand.  The  rules  that 
define  these  policies  can  be  shared  between  users. 

This  user's  guide  replaces  General  Technical  Report  INT- 196  (Crookston  1985). 
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APPENDIX  A:  OUTPUT  FROM  EXAMPLE  1 


The  tree  data  file  used  in  running  example  1  is  listed  below.  The  data  on  each 
record  are  arranged  according  to  the  default  tree  data  format  for  Version  6  of  the 
Prognosis  Model.  Part  of  the  output  created  by  running  the  example  is  listed  on 
the  following  two  pages.  This  output  was  generated  using  the  Inland  Empire  ver- 
sion 6.00  with  Regeneration  Establishment  Model  version  2.0. 
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STAND  GROWTH  PROGNOSIS  SYSTEM  VERSION  6.00  -  INLAND  EMPIRE 


09-12-1990  11:09:22 


OPTIONS  SELECTED  BY  INPUT 


PARAMETERS : 


STDIDENT 

INVYEAR 

NUMCYCLE 

IF 


STAND   ID-  EXAMPLEl 
INVENTORY  YEAR-  1990 
NUMBER  OF  CYCLES-  7 

MINIMUM  DELAY  TIME  BETWEEN  RESPONSES  TO  THE  EVENT  - 


Illustrate  IF,   THEN,   and  ENDIF 


BCCF  GT   150  AND  BTPA  GT   500  AND  AGE  i 
GT  20  AND  AGE  LT  60 

THEN  ACTIVITIES  WHICH  FOLLOW  WILL  NOT  BE  SCHEDULED  UNTIL  THE  EVENT  HAPPENS    (WHEN  THE  LOGICAL  EXPRESSION   IS  TRUE) . 

THINBTA         DATE/CYCLE-         0;    RESIDUAL-     300.00;   PROPORTION  OF  SELECTED  TREES  REMOVED-  1.000 
DBH  OF  REMOVED  TREES  WILL  RANGE  FROM  .0  TO  999.0   INCHES,  AND 

HEIGHT  OF  REMOVED  TREES  WILL  RANGE  FROM  .0  TO  999.0  FEET. 

ENDIF  ACTIVITIES  WHICH  FOLLOW  WILL  BE  SCHEDULED. 

STDINFO         FOREST-LOCATION  CODE-       118;    HABITAT  TYPE-590;   AGE-       30;   ASPECT  AZIMUTH   IN  DEGREES-   135.;    SLOPE-  50.% 
ELEVATION (lOO'S  FEET)-  56.0;    LATITUDE  IN  DEGREES-  45. 
HABITAT  TYPE  MAPPED  TO  510  FOR  THIS  PROJECTION. 

PROCESS         PROCESS  THE  STAND. 


OPTIONS  SELECTED  BY  DEFAULT 


(I4,Tl,n,F6.0,Il,A3,F4.1,F3.1,2F3.0,F4.1,Il,3(I2,I2),2Il,I2,2I3,2Il) 

BASAL  AREA  FACTOR-  40.0;    INVERSE  OF  FIXED  PLOT  AREA-     300.0;   BREAK  DBH-  5.0 
NUMBER  OF  PLOTS-  11;    NON-STOCKABLE  PLOTS-  1;    STAND  SAMPLING  WEIGHT-  11.00000 

STAND  ATTRIBUTES  ARE  CALCULATED  PER  ACRE  OF  STOCKABLE  AREA.      STAND  STATISTICS 
IN  SUMMARY  TABLE  ARE  MULTIPLIED  BY      .90  9  TO  INCLUDE  TOTAL  STAND  AREA. 


STAND   ID-  EXAMPLEl 


MANAGEMENT   ID-  NONE 


ACTIVITY  SCHEDULE 

Illustrate  IF,  THEN,   and  ENDIF 


CYCLE     DATE     EXTENSION     KEYWORD       DATE  PARAMETERS: 


1990 
2000 
2010 
2020 
2030 
2040 
2050 


CALIBRATION  STATISTICS: 


NUMBER  OF  RECORDS  PER  SPECIES 
NUMBER  OF  RECORDS  WITH  MISSING  HEIGHTS 
NUMBER  OF  RECORDS  WITH  BROKEN  OR  DEAD  TOPS 
NUMBER  OF  RECORDS  WITH  MISSING  CROWN  RATIOS 


14 
2 
1 
1 


NUMBER  OF  RECORDS  AVAILABLE  FOR  SCALING 
THE  DIAMETER  INCREMENT  MODEL 


RATIO  OF  STANDARD  ERRORS 
(INPUT  DBH  GROWTH  DATA   :  MODEL) 


.66     1.00  1.00 


WEIGHT  GIVEN  TO  THE   INPUT  GROWTH  DATA  WHEN 
DBH  GROWTH  MODEL  SCALE  FACTORS  WERE  COMPUTED 


INITIAL  SCALE  FACTORS  FOR  THE 
DBH   INCREMENT  MODEL 


.85      1.00  1.00 


NUMBER  OF  RECORDS  AVAILABLE  FOR  SCALING 
THE  SMALL  TREE  HEIGHT   INCREMENT  MODEL 


INITIAL  SCALE  FACTORS  FOR  THE  SHALL  TREE 
HEIGHT  INCREMENT  MODEL 


1.00      1.00      1.00  1.00 
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STAND   ID:  EXAMPLEl 


STAND  GROWTH  PROGNOSIS  SYSTEM 
MANAGEMENT  CODE:  NONE 


VERSION  6.00  -  INLAND  EMPIRE  09-12-1990  11:09:24 

Illustrate  IF,  THEN,   and  ENDIF 


STAND  COMPOSITION    (BASED  ON  STOCKABLE  AREA) 


STAND 
YEAR  ATTRIBUTES 


TREES 

VOLUME : 
TOTAL 
MERCH 
MERCH 

ACCRETION 
MORTALITY 

TREES 

VOLUME : 
TOTAL 
MERCH 
MERCH 

REMOVAL 

VOLUME : 
TOTAL 
MERCH 
MERCH 


ACCRETION 
MORTALITY 

TREES 

VOLUME : 
TOTAL 
MERCH 
MERCH 

ACCRETION 
MORTALITY 


PERCENTILE  POINTS   IN  THE 
DISTRIBUTION  OF  STAND  ATTRIBUTES  BY  DBH 


(DBH   IN  INCHES) 


5  .  0 
5.0 


6.5 
8.2 


8.0 
9.4 


9.5 
9.6 


10.9 
10  .  9 


12.7 
12.7 


7.2 

9 

2 

10 

0 

11 

0 

13 

3 

15 

7 

8.2 

9 

4 

10 

3 

11 

1 

13 

3 

15 

7 

8.5 

9 

4 

10 

3 

11 

2 

13 

3 

15 

7 

6.8 
7.2 


8  .  5 
9.2 


9.4 

10  .  0 


10.7 
10.4 


13.3 
12.4 


15.7 
15  .  7 


8 

6 

10 

6 

11 

4 

12 

8 

15 

3 

20 

2 

9 

2 

10 

6 

11 

6 

13 

1 

15 

3 

20 

2 

9 

4 

10 

7 

11 

7 

13 

1 

15 

5 

20 

2 

9 

0 

10 

6 

11 

7 

13 

1 

15 

5 

20 

2 

8 

5 

9 

9 

10 

9 

11 

9 

14 

0 

20 

2 

TOTAL/ACRE 

OF  STAND 
ATTRIBUTES 


DISTRIBUTION  OF  STAND  ATTRIBUTES  BY 
SPECIES  AND  3  USER-DEFINED  SUBCLASSES 


.  1 

1 

3 

2 

6 

2 

9 

4 

12 

7 

745  . 

TREES 

5  .  8 

8 

0 

9 

4 

9 

6 

11 

5 

12 

7 

2267. 

CUFT 

8.0 

9 

4 

9 

6 

10 

0 

11 

5 

12 

7 

1621  . 

CUFT 

8.0 

9 

4 

9 

6 

10 

0 

11 

5 

12 

7 

6403. 

BDFT 

35.%  DF2,      22.%  DFl,      20.%  GF2,      10.%  GFl 


115.  CUFT/YR 

24.  CUFT/YR 

561.  TREES 

3177.  CUFT 

2664.  CUFT 

10703.  BDFT 

261.  TREES 


31 

% 

DFl, 

28 

% 

LPl, 

12 

% 

GFl, 

11 

% 

LP  2 

36 

% 

LPl, 

23 

% 

DFl, 

14 

% 

LP2, 

10 

% 

LI 

35 

% 

LPl, 

22 

% 

DFl, 

14 

% 

LP2, 

12 

% 

LI 

37 

% 

DFl, 

27 

% 

GFl, 

13 

% 

LPl, 

11 

% 

DF2 

37 

% 

LPl, 

23 

% 

DFl, 

14 

% 

LP2, 

11 

% 

LI 

32 

% 

DF2, 

26 

% 

DFl, 

14 

% 

GF2, 

12 

% 

GFl 

4  . 1 

4 

9 

9 

4 

9 

4 

10 

0 

10 

0 

203. 

CUFT 

8.  7 

9 

4 

9 

4 

9 

4 

10 

0 

10 

0 

126. 

CUFT 

8.7 

9 

4 

9 

4 

9 

4 

10 

0 

10 

0 

471  . 

BDFT 

300.  TREES 


128.  CUFT/YR 
33.  CUFT/YR 


341.  TREES 


3930.  CUFT 
3616.  CUFT 
15131.  BDFT 


147.  CUFT/YR 
44.  CUFT/YR 


34 

% 

DFl, 

22 

% 

LPl, 

18 

% 

GFl, 

10 

% 

DF2 

32 

% 

DFl, 

24 

% 

LPl, 

17 

% 

GFl, 

9 

% 

LP  2 

29 

% 

DFl, 

26 

% 

LPl, 

17 

% 

GFl, 

10 

% 

LP2 

65 

% 

DF2, 

31 

% 

GF2, 

4 

% 

L2, 

1 

% 

LP  2 

72 

% 

DF2, 

16 

% 

L2, 

12 

% 

LP2, 

0 

% 

GF2 

60 

% 

DF2, 

22 

% 

L2, 

18 

% 

LP2, 

0 

% 

57 

% 

DF2, 

23 

% 

L2, 

20 

% 

LP2, 

0 

% 

49 

% 

DFl, 

22 

% 

GFl, 

12 

% 

LPl, 

10 

% 

LI 

39 

% 

DFl, 

37 

% 

GFl, 

10 

% 

LPl, 

6 

% 

LI 

36 

% 

LPl, 

27 

% 

DFl, 

12 

% 

LI, 

12 

% 

LP2 

47 

% 

DFl, 

26 

% 

GFl, 

9 

% 

LI, 

9 

% 

LPl 

38 

% 

DFl, 

26 

% 

GFl, 

18 

% 

LPl, 

7 

% 

LI 

36 

% 

DFl, 

26 

% 

GFl, 

18 

% 

LPl, 

7 

% 

LI 

34 

% 

DFl, 

27 

% 

GFl, 

19 

% 

LPl, 

8 

% 

LI 

45 

% 

GFl, 

36 

% 

DFl, 

7 

% 

LPl, 

5 

% 

LI 

31 

% 

DFl, 

29 

% 

LPl, 

16 

% 

GFl, 

11 

% 

LI 

(The  rest  of  the  Stand  Composition  table  and  the  Stand  Attributes  table  are  not  listed.) 

SUMMARY  STATISTICS    (PER  ACRE  OR  STAND  BASED  ON  TOTAL  STAND  AREA) 

START  OF  SIMULATION  PERIOD                                            REMOVALS                            AFTER  TREATMENT  GROWTH  THIS  PERIOD 
    MAI 

NO  OF                              TOP             TOTAL  MERCH  MERCH  NO  OF  TOTAL  MERCH  MERCH                              TOP     RES  PERIOD  ACCRE  MORT  MERCH 

YEAR  AGE  TREES     BA     SDI   CCF  HT     QMD     CU  FT  CU  FT  BD  FT  TREES  CU  FT  CU  FT  BD  FT     BA     SDI   CCF  HT       QMD  YEARS       PER     YEAR  CU  FT 

1990     30        677   102     241    128     65      5.3     2061      1473     5821            0            0            0            0  102     241   128     65      5.3  10      104          22  49.1 

2000     40       510   132     281   161     72     6.9     2888     2422     9730       238       184       115       428  119     227   142     72     8.9  10     117         30  60.5 

2010     SO       310  144     272  163     74     9.2     3573     3288   13755           0           0           0           0  144     272   163     74     9.2  10     134         40  68.1 

2020     60       310  165     303  178     80     9.9     4507     4226  18877           0           0           0           0  165     303   178     80     9.9  10     140         52  72.3 

2030     70       233  180     308  186     86  11.9     5387     5162  24291           0           0           0           0  180     308   186     86  11.9  10     164         64  75.4 

2040     80       234   194     327  192     92  12.3     6392     6174  30705           0           0           0           0  194     327  192     92   12.3  10     163         71  78.6 

2050     90       174  204     321   196  100  14.6     7317     7102  36446           0           0           0           0  204     321   196  100   14.6  10     161         80  80.2 

2060  100       167  210     326  196  106  15.2     8126     7914  41508           0           0           0           0  210     326  196  106  15.2  0         0           0  80.3 


STAND   ID-  EXAMPLEl 


MANAGEMENT   ID-  NONE 


ACTIVITY  SUMMARY 

Illustrate  IF,   THEN,   and  ENDIF 


CYCLE     DATE     EXTENSION     KEYWORD       DATE     ACTIVITY  DISPOSITION  PARAMETERS: 


1990 
2000 


BASE 
ESTB 


THINBTA  2000  DONE  IN  2000 
TALLY  2009     DONE  IN  2009 


300.00 
2000.00 


.00  999.00 


.00  999.00 


2019     DONE   IN  2019 


2020 
2030 
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APPENDIX  B:  EVENT  MONITOR  VARIABLES 


Variables  that  can  be  used  within  expressions  are  divided  into  four  groups  de- 
pending on  when  they  are  defined. 

Group  1:  Always  Defined 

AGE  Age  at  beginning  of  a  cycle 

ASPECT  Aspect  in  degrees  from  STDINFO  keyword 

BADBH  Before-thin  quadratic  mean  d.b.h. 

BBA  Before-thin  basal  area  per  acre 

BBDFT  Before-thin  Scribner  board  foot  volume 

BCCF^  Before-thin  crown  competition  factor 

BCCFSP  Before-thin  crown  competition  by  species.  This  "variable"  is 
actually  a  function  (appendix  C). 

BMCUFT  Before-thin  merchantable  cubic  foot  volume 

BTCUFT  Before-thin  total  cubic  foot  volume 

BTOPHT  Before-thin  average  top  height 

BTPA  Before-thin  trees  per  acre 

CENDYEAR       Ending  year  of  a  cycle  (same  as  the  beginning  year  of  the  follow- 
ing cycle,  minus  1) 

CYCLE  Cycle  number 

DBHDIST  Diameters  at  each  of  six  nominal  percentile  points  in  the  distri- 

bution of  each  of  11  different  attributes.  This  "variable"  is  actu- 
ally a  function  (appendix  C). 

ELEV  Elevation  in  feet  from  STDINFO  keyword 

EVPWASE         1.0  during  the  first  call  to  the  Event  Monitor  (before  cutting, 
see  fig.  1)  and  2.0  afi;er  cutting 

HABTYPE  Habitat  type  code  entered  on  the  STDINFO  keyword 

INVYEAR  The  inventory  year  of  the  stand 

NO  The  constant  0 

NUMTREES  Number  of  tree  records  stored  by  the  model 

RANN  A  uniform  random  number  between  0  and  1 

SAMPWT  Sampling  weight  entered  on  the  DESIGN  keyword 

SITE  Stand  site  index  entered  on  the  SITECODE  keyword 

SLOPE  Slope  percent  from  STDINFO  keyword 

SMR  Stand  mistletoe  rating  computed  when  the  variant  you  are 

using  contains  a  mistletoe  model 


^Several  Event  Monitor  variables  that  measure  species  contribution  to  total  CCF  have  been 
removed.  The  function  BCCFSP  (see  appendix  C)  replaces  BCCFn  (where  n  is  a  species  number 
1,  2, . . .,  11),  BCCFWP,  BCCFL,  BCCFDF,  BCCFGF,  BCCFWH,  BCCFC,  BCCFLP,  BCCFS, 
BCCFAF,  BCCFPP,  and  BCCFOTH.  The  function  ACCFSP  (see  appendix  C)  replaces  ACCFn 
(where  n  is  a  species  number  1,  2, .  . .,  11),  ACCFWP,  ACCFL,  ACCFDF,  ACCFGF,  ACCFWH, 
ACCFC,  ACCFLP,  ACCFS,  ACCFAF,  ACCFPP,  and  ACCFOTH. 
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SPMCDBH 


SUMSTAT 


YEAR 
YES 


Percentage  of  total  trees  per  acre,  total  cubic  volume,  or  total 
board  foot  volume  by  species,  tree  value  class,  and  for  a  specified 
diameter  range.  This  "variable"  is  actually  a  function  (appendix 
C). 

Elements  of  the  Summary  Statistics  table  are  available.  This 
"variable"  is  actually  a  function  (see  appendix  C). 

Beginning  year  of  a  cycle 

The  constant  1 


Group  2:  Defined  Only  After  Thinning  Each  Cycle 

AADBH  After-thin  quadratic  mean  d.b.h. 

ABA  After-thin  basal  area  per  acre 

ABDFT  After-thin  Scribner  board  foot  volume 

ACCF^  After-thin  crown  competition  factor 

ACCFSP  After-thin  crown  competition  by  species.  This  "variable"  is 

actually  a  function  (appendix  C). 

ADOMH  After-thin  average  top  height 

AMCUFT  After-thin  merchantable  cubic  foot  volume 

ATCUFT  After-thin  total  cubic  foot  volume 

ATPA  After-thin  trees  per  acre 

CUT  Set  equal  to  0.0  if  no  cutting  occurred  and  equal  to  1.0  if  cutting 
did  occur 

RBDFT  Removed  Scribner  board  foot  volume 

RMCUFT  Removed  merchantable  cubic  foot  volume 

RTCUFT  Removed  total  cubic  foot  volume 

RTPA  Removed  trees  per  acre 

Group  3:  Defined  When  Cycle  2  Starts 


ACC 
DBA 

DBA% 

DCCF 
DCCF% 

DTPA 
DTPA% 


Accretion  from  last  cycle,  cubic  feet/acre/year 

Basal  area  per  acre  at  the  beginning  of  current  cycle  minus  the 
basal  area  at  the  beginning  of  previous  cycle 

Basal  area  per  acre  at  the  beginning  of  current  cycle  divided  by 
the  basal  area  at  the  beginning  of  previous  cycle;  then  multiplied 
times  100 

Crown  competion  factor  at  the  beginning  of  current  cycle  minus 
the  factor  at  the  beginning  of  previous  cycle 

Crown  competion  factor  at  the  beginning  of  current  cycle  divided 
by  the  factor  at  the  beginning  of  previous  cycle;  then  multiplied 
times  100 

Number  of  trees  per  acre  at  the  beginning  of  current  cycle  minus 
the  number  at  the  beginning  of  the  previous  cycle 

Trees  per  acre  at  the  beginning  of  the  current  cycle  divided  by 
the  number  at  the  beginning  of  the  previous  cycle;  then  multi- 
plied times  100 
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MAI 

MORT 

PAI 


Mean  annual  increment  last  cycle,  cubic  feet 
Mortality  from  last  cycle,  cubic  feet/acre/year 
Periodic  annual  increment  last  cycle,  cubic  feet/acre 


Group  4:  Defined  by  Extensions  to  the  Prognosis  Model 

BRCHWT  The  branch  weighting  factor  for  a  given  stand  (defined  by  the 

PPE) 

BW%STND        The  stand  defoliation  level  caused  by  the  western  spruce 
budworm  during  the  previous  cycle 

DFTMPROB       Probability  of  a  Douglas-fir  tussock  moth  outbreak  in  the  cur- 
rent stand  given  that  an  outbreak  is  in  the  region 

MPBPROB         Probability  of  a  mountain  pine  beetle  outbreak  in  the  current 
stand  given  that  an  outbreak  is  in  the  region 

MPBTPAK         The  number  of  trees  per  acre  killed  by  the  mountain  pine  beetle 
during  the  previous  cycle 

NODES  The  number  of  branch  nodes  that  have  been  created  for  the 

current  stand  in  a  PPE  run  (Crookston  and  Stage  1989) 

RDACCESS        Equal  to  the  road  access  value  for  this  stand.  This  variable 
is  defined  if  the  RDACCESS  data  are  entered  in  the  PPE 
(see  "Entering  Spatial  Data",  in  Crookston  and  Stage  1989). 

SAMPWT  The  PPE  stand  weighting  factor,  see  "Stand  Weighting  Factors" 

(in  Crookston  and  Stage  1989). 

SELECTED        Takes  on  the  value  1.0  if  the  stand  has  been  selected  for  harvest 
by  the  PPE's  harvest  simulation  logic  (Crookston  and  Stage 
1989).  The  value  is  0.0  if  the  stand  has  not  been  selected. 

STARTYR  The  master  starting  year  coded  using  the  PPE  STARTYR 

keyword  (Crookston  and  Stage  1989) 

TM%DF  The  average  tree  defoliation  on  Douglas-fir 

TM%GF  The  average  tree  defoliation  on  grand  fir 

TM%STND        The  stand  average  tree  defoliation  level  caused  by  the  Douglas- 
fir  tussock  moth  during  the  previous  cycle  (Monserud  and 
Crookston  1982) 

WSBWPROB      Probability  of  a  western  spruce  budworm  outbreak  in  the 
current  stand  given  that  an  outbreak  is  in  the  region 
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APPENDIX  C:  FUNCTIONS  AND  OPERATORS 


Table  C-1 — Functions  and  operators  that  can  be  used  in  expressions 


Operator 


Precedence^ 


Description 


Exampie  of  usage 


ACCFSP 

BCCFSP 

DBHDIST 

BOUND 

DECADE 

LINiNT 

SPMCDBH 

SUMSTAT 

TIME 


ABS 

ALOG 

ALOG10 

EXP 

FRAC 

INT 

MAX 

MIN 

MOD 

SORT 


ARCCOS 

ARCSIN 

ARCTAN 

COS 

SIN 

TAN 


EC 

NE 

LT 

GT 

LE 

GE 

NOT 

AND 

OR 


I" 
I** 
I* 

I'* 
I" 
1« 


1* 
1^ 

1* 

1* 

1* 
1st 

1st 

1st 

ist 


13. 

1st 

IS. 

ist 
ist 

1* 


2nd 
3rd 

4th 


g.h 
gth 
gth 
glh 
gth 
gth 

7,h 

gth 
gth 


Prognosis  Model  functions 

See  description  on  page  18 
See  description  on  page  18 
See  description  on  page  18 
See  description  on  page  18 
See  description  on  page  18 
See  description  on  page  19 
See  description  on  page  19 
See  description  on  page  19 
See  description  on  page  20 

Other  functions 

Absolute  value 
Natural  logarithm  (base  e) 
Common  logarithm  (base  10) 
e  raised  to  power 
Truncate  integer  part^ 
Truncate  fractional  part^ 
Maximum  value  of  arguments 
Minimum  value  of  arguments 
Modulus" 
Square  root 

Trigonometric  functions  (arguments  in  radians) 

Arc  cosine 
Arc  sine 
Arc  tangent 
Cosine 
Sine 
Tangent 

Arithmetic  operators 

Exponentiate 
Change  sign 
Multiply 
Divide 
Add 

Subtract 

Logical  operators 

Equal 
Not  equal 
Less  than 
Greater  than 
Less  than  or  equal 
Greater  than  or  equal 
Logical  not 
Logical  and 
Logical  or  ^ 


ACCFSP(A) 

BCCFSP(A) 

DBHDIST(A,B) 

BOUND(A,B,C) 

DECADE(A,B.C) 

LININT(X,x,,x,,y,,y,) 

SPMCDBH(A,B.C,D,E) 

SUMSTAT(A,B) 

TIME(A,B.C) 


ABS(A) 

ALOG(A) 

ALOG  10(A) 

EXP(A) 

FRAC(A/B) 

INT(A/B) 

MAX(A,B,  .  .  .) 

MIN(A.B,  .  .  .) 

MOD(A,B) 

SQRT(A) 


ARCCOS(A) 

ARCSIN(A) 

ARCTAN(A) 

COS(A) 

SIN(A) 

TAN(A) 


A"B 

-A 

A*B 

A/B 
A+B 
A-B 


AEQB 

A  NEB 

ALE  B 

AGTB 

ALE  B 

AGES 

NOT  (A  GT  B) 

(A  GT  B)  AND  (A  LT  C) 

(A  GT  B)  OR  (A  LT  C) 


Operators  are  executed  in  order  of  precedence  within  parenthetical  groups.  For  example  consider  the  following: 
ALOG(A)"2.+5/C,  the  log  is  taken  first,  the  result  Is  raised  to  the  power  of  2,  then  5  is  divided  by  C  and  added  to  the  previ- 
ous result. 

^For  example:  FRAC(3.4)  Is  equal  to  0.4. 

^For  example:  INT(3.4)  is  equal  to  3.0. 

"Returns  the  remainder  after  the  first  argument  Is  divided  by  the  second.  For  example:  MOD{7,2)  Is  equal  to  1 .0, 
MOD(6,2)  is  equal  to  zero. 
^Inclusive  OR. 
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Prognosis  Model  Function  Descriptions 


ACCFSP        Returns  the  after-thin  crown  competition  factor  (ACCFSP),  or  the 
BCCFSP        before-thin  crown  competition  factor  (BCCFSP)  for  the  species  in- 
dicated as  an  argument  to  the  function.  Numeric  species  codes 
are  used  as  the  argument.  The  species  represented  depends  on 
the  regional  variant  of  the  Prognosis  Model  you  are  using.  For 
example,  in  the  Inland  Empire  variant,  species  7  is  lodgepole 
pine.  BCCFSP(7)  is  the  before-thin  crown  competition  factor 
for  lodgepole  in  that  variant. 

DBHDIST     Returns  the  diameter  of  the  tree  corresponding  to  the  nominal 
percentile  in  the  distribution  of  a  specific  attribute.  Table  C-2 
displays  the  coding  scheme  used  to  define  arguments  for  the 
DHBDIST  function.  For  example,  DBHDIST(3,4)  returns  the 
d.b.h  of  the  70*  percentile  tree  (because  the  second  argument 
is  4)  in  the  distribution  of  trees  per  acre  (because  the  first 
argument  is  3). 


Table  C-2 — Coding  scheme  used  in  the  DBHDIST  function 


Second  argument 


 First  argument   Percentile  in  distribu- 

Code  Attribute  Code       tion  of  the  attribute 


1 

Accretion  (ft^/acre/year) 

1 

10-percentile 

2 

Mortality  (fp/acre/year) 

2 

30-percentile 

3 

Trees/acre 

3 

50-percentile 

4 

Total  cubic  volume/acre 

4 

70-percentile 

5 

Merchantable  volume/acre 

5 

90-percentile 

6 

Board  foot  volume/acre 

6 

100-percentile 

7 

Removed  trees/acre 

8 

Removed  total  cubic  volume/acre 

7 

Total  of  the  attri- 

9 

Removed  merchantable  volume/acre 

bute  is  returned 

10 

Removed  board  foot  volume/acre 

rather  than  the  d.b.h. 

11 

Residual  trees/acre 

at  a  percentile 

BOUND         Return  the  second  argument  if  it  is  greater  than  the  first  argu- 
ment and  less  than  the  third.  If  the  second  argument  is  less  than 
the  first  argument,  the  first  argument  is  returned;  and  if  the  sec- 
ond argument  is  greater  than  the  third  argument  the  third  argu- 
ment is  returned.  If  the  first  argument  is  greater  than  the  third, 
the  function  is  undefined.  Examples: 

the  value  of  BOUND(0.0,0.98,1.0)  is  0.98; 
the  value  of  BOUND(0.0,1.9,1.0)  is  1.0; 
the  value  of  BOUND(0.0,-28,1.0)  is  0.0;  and 
the  value  of  BOUND(0.0,0.98,-11)  is  undefined. 

DECADE       Returns  the  argument  that  corresponds  to  the  decade  the  run  is 
in.  For  example,  the  value  of  DECADE(15,A/B,C**2.1)  will  be 
15  any  time  during  the  first  decade  of  the  run,  A/B  during  the 
second,  and  C**2.1  during  the  third  and  all  subsequent  decades. 
Decades  are  defined  as  offsets  from  the  inventory  year  entered 
on  the  INVYEAR  keyword.  If  1988  is  the  inventory  year,  the  first 
decade  of  the  run  is  years  1988  through  1997,  the  second  is  years 
1998  through  2007,  and  so  on. 
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LININT         Returns  a  linear  interpolation  between  points  on  a  simple  Y-over-X 
graph.  The  general  form  is 

LININT  (X,  x,,x„...,x„,  y^,y^  

where  {x^,y^,{x^,y^,...,{.x^,y^  define  points  on  the  graph  and  X  is 
some  arbitrary  value  along  the  X-axis.  The  function  returns  the 
appropriate  value  along  the  Y-axis  derived  from  a  linear  interpola- 
tion on  the  line  defined  by  connecting  the  points  of  the  graph.  Note 
that  Xj  through  x^  must  be  in  ascending  sequence.  If  X  is  less  than 
or  equal  to  Xj,  then  LININT  returns  the  value  of  yj,  and  if  X  is 
greater  than  or  equal  to  x^,  LININT  returns  the  value  of  y^. 

At  least  2  points  must  be  provided,  all  arguments  must  be  defined, 
and  the  total  number  of  arguments  must  be  an  odd  number.  If  any 
of  these  conditions  are  violated,  the  result  of  LININT  is  undefined. 
The  maximum  number  of  allowable  points  depends  on  the  specific 
use  within  an  expression  and  may  vary  by  computer  installation. 
In  any  case,  up  to  20  points  should  be  permissible. 

SPMCDBH    Returns  the  trees,  basal  area,  total  cubic  volume,  or  board  foot  vol- 
ume per  acre  for  a  given  species,  tree-value  class,  and  range  of  di- 
ameter. There  are  three  required  arguments.  The  first  is  a  numeric 
code  indicating  which  measurement  is  desired,  as  follows: 

1  =  trees  per  acre, 

2  =  basal  area  per  acre, 

3  =  total  cubic  volume/acre,  or 

4  =  total  board  foot  volume/acre. 

The  second  argument  is  the  numeric  species  code  where  0  indicates 
that  the  sum  over  all  species  is  desired  and  other  values  correspond 
to  the  species  numeric  codes  (species  numeric  codes  are  variant 
specific). 

The  third  argument  is  the  tree-value  class  (IMC  codes  1,  2,  or  3;  see 
Wykofif  and  others  1982,  p.  16)  where  0  indicates  that  the  sum  over 
all  tree-value  classes  is  desired. 

The  fourth  and  fifth  arguments  optionally  define  a  diameter  range 
for  trees  included  in  the  sum. 

Examples:  SPMCDBH(  1,7,0)  returns  the  trees  per  acre  that  are 
lodgepole  pine;  SPMCDBH(2,0,3)  returns  the  basal  area/acre  that  is 
in  IMC  class  3;  SPMCDBH(3,3,1,10)  returns  the  total  cubic  volume/ 
acre  that  is  Douglas-fir,  IMC  class  1,  and  in  trees  greater  than  10 
inches  d.b.h.;  and  SPMCDBH(3,3, 1,10,20)  is  just  like  the  previous 
example  except  that  the  trees  must  be  greater  than  10  inches  and 
less  than  20  inches  d.b.h. 

SUMSTAT     Returns  a  value  from  the  Summary  Statistics  Table.  The  first  argu- 
ment determines  the  row  (which  is  the  same  as  the  cycle  number) 
and  the  second  determines  the  column.  Each  column  corresponds 
to  a  different  stand  attribute.  The  following  codes  are  used  to  re- 
trieve attributes  available  using  SUMSTAT: 


1 

=  year 

10 

=  removed  merch  bd  fl  volume 

2 

=  age 

11 

=  basal  area/acre  after  thinnings 

3 

=  trees/acre 

12 

=  ccf  after  thinnings 

4 

=  total  fl^  volume 

13 

=  top  height 

5 

=  merch  ft^  volume 

14 

=  period  length  (years) 

6 

=  merch  bd  ft  volume 

15 

=  accretion  (fl7acre/year) 
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7  =  removed  trees/acre  16  =  mortality  (ft^/acre/year) 

8  =  removed  total  ft^  volume      17  =  stand  sampling  weight. 

9  =  removed  merch  ft^  volume 

If  the  row  number  references  statistics  that  have  not  been  com- 
puted, the  value  of  SUMSTAT  is  undefined. 

TIME  Returns  the  first  argument  if  the  current  year  in  the  simulation 

is  less  than  the  second  argument.  Returns  the  third  argument  if 
the  current  year  in  the  simulation  is  greater  or  equal  to  the  second 
argument  and  less  than  the  fourth,  and  so  on. 

For  example,  consider  TIME  (3.0,2010,A/B,2030,A*C).  For  all 
the  years  of  the  simulation  prior  to  2010,  the  value  of  TIME  will 
be  3.0.  For  the  years  2010  to  2029,  the  value  of  time  will  be  A/B. 
For  year  greater  or  equal  to  2030,  the  TIME's  value  will  be  A*C. 


20 


APPENDIX  D:  KEYWORD  SUMMARY 


The  keywords  described  in  this  guide  are  summarized  below.  The  numbers  in 
parentheses  refer  to  the  page  number(s)  in  the  text  where  more  information  can 
be  found. 


AGPLABEL 
(8) 


ALSOTRY 
(9) 


COMPUTE 
(5) 


ENDIF 
(3) 

IF 

(3) 


SPLABEL 
(8) 

THEN 
(3) 


Enter  the  policy  labels  for  a  specific  activity  group  on  supplemental 
data  records  that  follow  this  keyword.  Separate  each  label  with  one 
comma,  do  not  exceed  100  characters,  and  use  an  ampersand  (&)  to 
continue  on  the  next  record. 

Signals  that  the  activities  that  follow  are  an  alternative  group  that 
are  scheduled  when  the  event  happens. 

field  1:  A  value  that  is  multiplied  by  the  branch  weighting  factor 
when  the  event  occurs;  default  is  1.0.  Applicable  when 
using  the  PPE. 

Enter  one  or  more  expressions  that  define  variables. 

field  1:  The  date  or  cycle  in  which  the  expressions  are  to  be  evalu- 
ated; default  is  1.  Enter  a  0.0  if  you  want  the  expression 
to  be  evaluated  every  cycle. 

Supplemental  data  record(s)  contain  expressions  such  as: 
NORMAL  =  25000*(BADBH+1)**(-1.588). 

Activities  not  included  between  an  IF  and  an  ENDIF  are  scheduled 
for  the  year  indicated  in  field  1. 

Signals  that  a  logical  expression  follows  on  supplemental  records. 

field  1:  The  minimum  waiting  time  before  the  event  may  happen 
again;  default  is  zero  years. 

Supplemental  data  record(s):  Enter  a  logical  expression;  use  an 
ampersand  (&)  to  indicate  that  an  expression  is  continued  on  the 
next  record.  Do  not  exceed  200  characters  per  expression. 

Enter  the  policy  labels  applicable  to  a  specific  stand  on  supplemen- 
tal data  records  that  follow  this  keyword.  See  AGPLABEL  for  a 
description  of  how  to  code  the  supplemental  data  record. 

Signals  that  activities  will  be  scheduled  following  an  event. 

field  1:  A  value  that  is  multiplied  by  the  branch  weighting  factor 

when  the  event  occurs;  default  is  1.0.  Applicable  only  when 
using  the  PPE. 
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Crookston,  Nicholas  L.  1990.  User's  guide  to  the  event  monitor:  part  of  Prognosis  Model 
version  6.  Gen.  Tech.  Rep.  INT-275.  Ogden,  UT:  U.S.  Department  of  Agriculture, 
Forest  Service,  Intermountain  Research  Station.  21  p. 

Describes  how  to  use  the  Event  Monitor  to  dynamically  invoke  management  activities 
in  the  Prognosis  Model  for  Stand  Development.  The  program  accepts  statements  of 
conditions — expressed  as  logical  expressions  of  stand-state  variables — ^to  be  met  and 
sets  of  activities  to  be  simulated  when  the  conditions  are  met.  The  combination  of  a 
condition  and  a  set  of  activities  is  considered  a  rule  of  stand  management.  Several 
rules  may  be  used  to  define  a  stand  management  policies.  Replaces  General  Technical 
Report  INT-196  (Crookston  1985);  retains  most  features  of  the  Event  Monitor,  provides 
several  new  features. 


KEYWORDS:  expert  systems,  simulation,  stand  management 


The  InteriTKDuntain  Research  Station  provides  scientific  knowledge  and  technology  to  im- 
prove management,  protection,  and  use  of  the  forests  and  rangelands  of  the  Intermountain 
West.  Research  is  designed  to  meet  the  needs  of  Natbnal  Forest  managers,  Federal  and 
State  agencies,  industry,  academic  institutions,  public  and  private  organizations,  and  indi- 
viduals. Results  of  research  are  made  available  through  publications,  symposia,  workshops, 
training  sessions,  and  personal  contacts. 

The  lnternx)untain  Research  Station  territory  includes  Montana,  Idaho,  Utah, 
Nevada,  and  western  Wyoming.  Eighty-five  percent  of  the  lands  in  the  Station  area,  about 
231  million  acres,  are  classified  as  forest  or  rangeland.  They  include  grasslands,  deserts, 
shnjblands,  alpine  areas,  and  forests.  They  provide  fiber  for  forest  industries,  minerals  and 
fossil  fuels  for  energy  and  industrial  devetopment,  water  for  domestic  and  industrial  con- 
sumption, forage  for  livestock  and  wildlife,  and  recreation  opportunities  for  millions  of  visitors. 

Several  Station  units  conduct  research  in  additional  westem  States,  or  have 
missions  that  are  national  or  international  in  scope. 

Station  laboratories  are  located  in: 

Boise,  Idaho 

Bozeman,  Montana  (in  cooperation  with  Montana  State  University) 
Logan,  Utah  (in  cooperation  with  Utah  State  University) 
Missoula,  Montana  (in  cooperation  with  the  University  of  Montana) 
Moscow,  Idaho  (in  cooperation  with  the  University  of  Idaho) 
Ogden,  Utah 

Provo,  Utah  (in  cooperation  with  Brigham  Young  University) 
Reno,  Nevada  (in  cooperation  with  the  University  of  Nevada) 

USDA  policy  prohibits  discrimination  because  of  race,  color,  national  origin,  sex,  age,  reli- 
gion, or  handicapping  condition.  Any  person  wtio  believes  he  or  she  has  been  discriminated 
against  in  any  USDA-related  activity  should  immediately  contact  the  Secretary  of  Agriculture. 
Washington.  DC  20250. 


